Configuration File

The application settings are stored in an XML file that lies in the same directory as the program (default location is C:\Program Files (x86)\LS Retail\NAV\LSStart) with the file name LSStart.exe.config. The file can be configured with any text editor. The following settings are available:

Table 1: Configuration parameters

Parameter Description
AllowDesign Allow user to add new start buttons.
AllowClose Allow user to close LS Nav Start.
FormSize LS Nav Start form size.
Fullscreen Start in full screen.
GridLayout Buttons are arranged in grid layout, rather than lines.
RefreshInterval Time interval (in seconds) to check POS availability (failover POS).
Port Communication port between LS Nav Start and a POS started with the tool. Used for failover functionality and terminal selection.
DebugLogFile If set, debug logs are produced for LS Nav Start.
DevelopersOptions If checked, additional "Run Debugger" options will become available when you right-click a Start button.
ConvertOptions Similar option exists in NAV, when querying the database, the table name characters listed in this options will be converted "_".
Failover Checks
PingTimeout While POS is running, LS Nav Start will check periodically if the Service Tier is connectable to see if it's up and running. This determines how long to wait for an answer from the service tier (in milliseconds).
DatabaseTimeout Similar to PingTimeout, but how long to wait to be connected to the database (in seconds).
DisableFailoverCheck If true, the LS Nav Start will not monitor if current service tier is available or service tier is registered in the database. This will have an effect on the failover functionality.
Style
InterfaceXMLFile Path to interface XML file.
StyleProfileID Style profile
ButtonsFontID Font ID for start button menu.
ButtonsSkinID Skin ID for start button menu.
CloseFontID Font ID for close button menu.
CloseSkinID Skin ID for close button menu.
Custom panel
InterfaceProfileID Interface profile
MenuXMLFile Path to menu XML file.
StyleXMLFile Path to style XML file.
MenuProfileID Menu profile
PanelID  
ButtonPadControlID Allow user to add new start buttons.
CloseButtonPadControlID Allow user to close LSStart.
Program list (start buttons)
NavList List of programs that are represented as a start button. See Table 2 for definition.

 

Table 2: Configuration parameters for a single program

Parameter Description
Title Title that appears on start button.
ExePath Path to executable. (Required)
Arguments Arguments to pass to executable on run.
WaitForExit Puts LSStart on hold while the program is executing.
Credentials
Username In order to run as a different user, specify a user name, password, and domain.
Password Password for user.
Domain Domain for user.
NetOnly Run as with net logon.
NAV specific parameters
Company Dynamics NAV company to run.
ServiceTierList List of service tiers.
Object Dynamics NAV object to run.

 

Table 3: Service Tier Instance

Parameter Description
Name Name of service tier (f. ex. DynamicsNav71).
Host Computer host name.
Port Service tier port.

The application behind a start button is defined with the parameters defined in Table 2. 

  • Specify the ExePath and optionally Arguments for any executable.
  • In order to run as a different user, specify Username, Password and Domain. Set NetOnly to True if the credentials specified are for remote access only.
  • To run a Dynamics NAV role tailor client, a POS, or a specific NAV object, you must specify the NAV-specific parameters (the last group in Table 2).